Third Party API Integration

If you’re running a campaign for a brand for a sweepstakes, sampling, in-person testing, or collecting review content on behalf of a brand, you can submit an API call to send in the reviews collected. The review content that you collect is then sent to the brand through PowerReviews’ API.

You’ll need a technical team to setup the API call. This is the only technical work required for this process.

API Integration Process

In order to start and successfully complete an integration with the PowerReviews API, you must complete the following steps before you begin your campaign:

If you’re working on a campaign for a product that hasn’t launched yet, you’ll still follow the same integration process steps. However, it’s important to note, that the brand must provide the page id or a product feed to PowerReviews that includes the product information.

  1. Send an email to sampling@powerreviews.com with your request including the brand you’re supporting.
  2. Receive and complete the Sampling Detail Spreadsheet. Once your campaign is approved, the brand’s Client Success Director provides you with the Sampling Detail Sheet.
  3. Receive account credentials, API key, and page IDs from PowerReviews. Once PowerReviews receives your completed spreadsheet, we provide you with the necessary account credentials to send the review content via an API call.
  4. Implement the API call. For more information, see Read API Documentation.
  5. Submit a test review via the API.
  6. Receive confirmation from PowerReviews that the test review submitted successfully, and then pass the rest of the review content via the API.

Pharmaceutical clients have strict review guidelines. As part of the process, you’ll need to have an additional discussion about these guidelines with PowerReviews if you're working with a pharmaceutical client.

API Integration Best Practices

In order to easily send the review information to PowerReviews, the following mandatory fields are required in your campaign’s survey or write-a-review form:

  • Headline - the title of the review.
  • Rating - the star rating for the review.
  • Comments - the content of the review.
  • Location - the location of the person leaving the review.
  • Nickname - the name of the person leaving the review.

PowerReviews provides your team with the relevant page ids. When you use the API, the page ids hit the review template endpoint and retrieve the appropriate fields to build the write-a-review form. It’s a best practice to use the GetReviewTemplate call each time you make a call. This ensures that you pull down the template and understand what fields are included.

The brand may require additional fields beyond the mandatory fields. You must comply with brand requirements, and should add any additional fields to the survey or form that the brand requires.

Your company can also collect reviews on your website and feed the reviews to PowerReviews after the completion of a campaign. However, these reviews should contain iOvation data, especially if you're going to syndicate the reviews with the Open Syndication Network.